DİA Web Servisleri Geliştirici Dokümanı v1

Giriş

Dia Ticari Sistemi ile diğer yazılım sistemleri arasında veri alışverişinin otomatik olarak yapılabilmesi

amacıyla  Dia  tarafından  yazılım  içerisinde  sunulan  veri  aktarım  işlevlerinin  bazıları  web  servisi

olarak dışarı açılmıştır. Bu doküman bu işlevlerin kullanımı hakkında teknik bilgi vermektedir.

Genel Bilgiler

Dia  web  servisleri  JSON­RPC  (version  1)  yöntemini  kullanmaktadır.  Çeşitli  dil  ve  platformlarda

JSON­RPC gerçekleştirimleri bulunmaktadır (http://json­rpc.org/wiki/implementations).

● Örnek Java Kütüphanesi: http://software.dzhuvinov.com/json­rpc­2.0­base.html

● Örnek C# Kütüphanesi: http://code.google.com/p/jayrock/

JSON­RPC  çağrılarında  kullanılacak  olan  URL  http://sunucukodu.json.dia.gen.tr/ şeklindedir.  Bu

URL’deki sunucukodu kısmı hangi Dia sunucusu için geliştirme yapılıyorsa onunla değiştirilmelidir.

Veri aktarımı amacıyla kullanılan tüm metotların ilk iki parametresi kullanıcı ismi ve şifredir. Bahsi

geçen kullanıcı, Dia sistemi üzerinden tanımlı olan bir kullanıcıdır. Web servisleri ile yapılacak tüm

işlemler  bu  kullanıcının  yetkilerine  tabiidir.  Dia  üzerinden  gerekli  yetki  ayarlamaları  yapılarak  web

servisi kullanıcılarının yapabilecekleri işlemler kısıtlanabilir. Web servisi kullanacak olan kullanıcıda

mutlaka bulunması gereken yetkiler Genel Yetkiler altında yer alan Veri Aktarımı (Dışarıdan) ve Veri

Aktarım Sihirbazı yetkileridir.

● İşlemlerde  kullanılacak firma,  kullanıcının öntanımlı firmasıdır. İşlemlerin  yapılacağı dönem

ilgili firmanın öntanımlı dönemidir.

● Web servisinde kullanılan kullanıcı, sisteme hali hazırda bağlı ise bağlantısı kopartılacaktır.

Bu nedenle web servisi için tamamen ayrı bir kullanıcı tanımlanması önerilmektedir.

● Tüm  metotların  giriş  parametreleri  string  tipindedir.  Metotlardan  dönen  cevap  aşağıdaki

formatlardan birisinde gelir: ○ {"durum":"sonuckodu"}

○ {"durum":"sonuckodu","xmldata":"veriicerenxml"}

○ {"durum":"sonuckodu","hatalar":{"hataanahtari":"hataaciklamasi"}}

○ {"durum":"sonuckodu","_unknown_":{"hataanahtari":"hataaciklamasi"}}

Sonuç Kodu Anlamı "200" İşlem başarılı "400" İşlem  parametrelerinde  hata  var.  Daha  fazla  bilgi  için  "hatalar"anahtarlı

değere bakılabilir. "401" Yetki sorunu, muhtemelen kullanıcı adı ve/veya şifre hatalı “405” Lisans sorunu, sunucu üzerinde web servis lisansı tanımlı değil "500" Sunucuda  öngörülmeyen  hata  oluştu.  "_unknown_"anahtarlı  değer  daha

fazla bilgi içerebilir.

Fonksiyonlar

1.ImportFonksiyonları‐İçeAktarım

2.ExportFonksiyonları‐DışarıAktarım

a.scf.xmlImportStok

b.scf.xmlImportCari

c.scf.xmlImportFatura

d.scf.xmlImportIrsaliye

e.scf.xmlImportSiparis

f.scf.xmlImportCariHesapFisi

g.scf.xmlImportMalzemeFisi

h.scf.xmlImportKasaFisi

i.bcs.xmlImportBankaFisi

a.scf.xmlExportStok

b.scf.xmlExportCari

c.scf.xmlExportFatura

d.scf.xmlExportIrsaliye

e.scf.xmlExportSiparis

f.scf.xmlExportCariHesapFisi

g.scf.xmlExportMalzemeFisi

h.scf.xmlExportKasaFisi

i.bcs.xmlExportBankaFisi

Örnekler

● Java XML

● .Net C# XML

● .Net C# JSON

İçe Aktarım Metotları (Dia’ya)

scf.xmlImportStok(username,

password,

xmlData,

hataolursa="HATA_OLURSA_IPTAL_ET",

ozelkodlar="AKTARMA",

yetkikodlari="AKTARMA",

markalar="AKTARMA",

benzerkod="BENZER_KODDA_HATA_VER"

)

● XML  formatında  hazırlanmış  stok  kart  verilerinin  Dia  sistemine  aktarılması  amacıyla

kullanılan metottur.

● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● xmlData:Aktarılacak stok bilgisini içeren XML verisi. İstenirse GZIP yöntemi ile sıkıştırılıp

daha  sonra  Base64  kodlamasından  geçirilmiş  veri  de  gönderilebilir.  Sistem  gönderilen

verinin formatını otomatik olarak algılayacak ve gerekli açma işlemini yapacaktır.

● hataolursa: Hata durumunda davranış biçimi.

● ozelkodlar: Stok özel kodları aktarım davranışı.

● yetkikodlari: Stok yetki kodları aktarım davranışı.

● markalar: Stok markalarının aktarma davranışı.

● benzerkod: Stok kodunun mevcut başka bir koda benzerliği durumundaki davranış.

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer:

■ "HATA_OLURSA_IPTAL_ET"

○ Alabileceği değerler:

■ "AKTARMA"

■ "AKTAR_YOKSA_OLUSTUR"

■ "SADECE_TANIMLI_AKTAR"

○ Öntanımlı değer:

■ "AKTARMA"

○ Alabileceği değerler:

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

○ Öntanımlı değer:

■ "AKTARMA"

○ Alabileceğı değerler:

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

○ Öntanımlı değer:

■ "AKTARMA"

○ Alabileceği değerler:

■ "BENZER_KODDA_HATA_VER"

■ "BENZER_KODA_YENI_KOD_VER"

■ "KAYDI_YOKSAY"

■ "BENZER_KODLU_KAYDI_GUNCELLE"

○ Öntanımlı değer:

■ "BENZER_KODDA_HATA_VER"

scf.xmlImportCari(username,

password,

xmlData,

hataolursa="HATA_OLURSA_IPTAL_ET",

ozelkodlar="AKTARMA",

yetkikodlari="AKTARMA",

vergidaireleri="AKTAR_YOKSA_OLUSTUR",

benzerkod="BENZER_KODDA_HATA_VER"

)

● XML  formatında  hazırlanmış  cari  kart  verilerinin  Dia  sistemine  aktarılması  amacıyla

kullanılan metottur.

● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● xmlData:Aktarılacak  cari bilgisini içeren XML  verisi. İstenirse GZIP  yöntemi ile  sıkıştırılıp

daha  sonra  Base64  kodlamasından  geçirilmiş  veri  de  gönderilebilir.  Sistem  gönderilen

verinin formatını otomatik olarak algılayacak ve gerekli açma işlemini yapacaktır.

● hataolursa: Hata durumunda davranış biçimi.

● ozelkodlar: Cari kart özel kodları aktarım davranışı.

● yetkikodlari: Cari kart yetki kodları aktarım davranışı.

● vergidaireleri: Cari kartın vergi dairesi bilgisini aktarma davranışı.

● benzerkod: Cari kart kodunun mevcut başka bir koda benzerliği durumundaki davranış.

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer:

■ "HATA_OLURSA_IPTAL_ET"

○ Alabileceği değerler:

■ "AKTARMA"

■ "AKTAR_YOKSA_OLUSTUR"

■ "SADECE_TANIMLI_AKTAR"

○ Öntanımlı değer:

■ "AKTARMA"

○ Alabileceği değerler:

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

○ Öntanımlı değer:

■ "AKTARMA"

○ Alabileceğı değerler:

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

○ Öntanımlı değer:

■ "AKTAR_YOKSA_OLUSTUR"

○ Alabileceği değerler:

■ "BENZER_KODDA_HATA_VER"

■ "BENZER_KODA_YENI_KOD_VER"

■ "KAYDI_YOKSAY"

■ "BENZER_KODLU_KAYDI_GUNCELLE"

○ Öntanımlı değer:

■ "BENZER_KODDA_HATA_VER"

scf.xmlImportFatura(username,

password,

xmlData,

subeKodu="000001",

depoKodu="DEPOYU_KAYITTAN_AL",

otomatikfisno="FISNO_KAYITTAN_ALINSIN",

otomatikfaturano="FISNO_KAYITTAN_ALINSIN",

hataolursa="HATA_OLURSA_IPTAL_ET",

ozelkodlar="AKTARMA",

yetkikodlari="AKTARMA",

benzerlikkontrolu="BENZERLIK_KONTROLU_YAPILSIN",

eslenmeyenler="HATA_OLURSA_IPTAL_ET",

carikartkontrolu="CARI_KONTROLU_VAR"

)

● XML formatında hazırlanmış fatura verilerinin Dia sistemine aktarılması amacıyla kullanılan

metottur.

● username:Dia kullanıcı ismi

● password:Dia kullanıcı şifresi

● xmlData:Aktarılacak fatura bilgisini içeren XML verisi. İstenirse GZIP yöntemi ile sıkıştırılıp

daha  sonra  Base64  kodlamasından  geçirilmiş  veri  de  gönderilebilir.  Sistem  gönderilen

verinin formatını otomatik olarak algılayacak ve gerekli açma işlemini yapacaktır.

● subeKodu: Faturaların aktarılacağı şubenin kodu.

● depoKodu: Faturaların aktarılacağı deponun kodu.

● otomatikfisno: Faturaların fiş no bilgilerinin nasıl oluşturulacağını belirtir.

● otomatikfaturano: Faturaların fatura no bilgilerinin nasıl oluşturulacağını belirtir.

● hataolursa: Hata durumunda davranış biçimi.

● ozelkodlar: Fatura özel kodları aktarım davranışı.

○ Dia sisteminde tanımlı bir şube kodu.

○ Öntanımlı değer:

■ "000001"

○ Dia  sisteminde  tanımlı  bir  depo  kodu  ya  da  XML  verisi  içerisinde  yer  alan  depo

kodunun kullanılması için özel değer "DEPOYU_KAYITTAN_AL"

○ Öntanımlı değer:

■ "DEPOYU_KAYITTAN_AL"

○ Alabileceği değerler:

■ "FISNO_KAYITTAN_ALINSIN"

■ "FISNO_OTOMATIK_VERILSIN"

○ Öntanımlı değer:

■ "FISNO_KAYITTAN_ALINSIN"

○ Alabileceği değerler:

■ "FISNO_KAYITTAN_ALINSIN"

■ "FISNO_OTOMATIK_VERILSIN"

○ Öntanımlı değer:

■ "FISNO_KAYITTAN_ALINSIN"

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer:

■ "HATA_OLURSA_IPTAL_ET"

○ Alabileceği değerler:

■ "AKTARMA"

■ "AKTAR_YOKSA_OLUSTUR"

○ Öntanımlı değer:

● yetkikodlari: Fatura yetki kodları aktarım davranışı.

○ Alabileceği değerler:

■ "SADECE_TANIMLI_AKTAR"

■ "AKTARMA"

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

■ "AKTARMA"

○ Öntanımlı değer:

● benzerlikkontrolu:Fatura numarası daha önce girilmiş kayıtlarla aynı olan faturalar için

davranış biçimi.

○ Alabileceğı değerler:

○ Öntanımlı değer:

● eslenmeyenler: Fatura bilgileri eşlenirken hata oluşursa davranış biçimi.

○ Alabileceği değerler:

■ "BENZERLIK_KONTROLU_YAPILSIN"

■ "BENZERLIK_KONTROLU_YAPILMASIN"

■ "BENZER_OLANI_YOKSAY"

■ "BENZERLIK_KONTROLU_YAPILSIN"

○ Öntanımlı değer:

● carikartkontrolu: Fatura bilgileri eşlenirken cari kart bilgisinin kontrol şekli.

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

■ "HATA_OLURSA_IPTAL_ET"

○ Öntanımlı değer:

■ "CARI_KONTROLU_VAR"

■ "CARI_KONTROLU_YOK"

■ "CARI_KONTROLU_VAR"

scf.xmlImportIrsaliye(username,

password,

xmlData,

subeKodu="000001",

depoKodu="DEPOYU_KAYITTAN_AL",

otomatikfisno="FISNO_KAYITTAN_ALINSIN",

otomatikirsaliyeno="FISNO_KAYITTAN_ALINSIN",

hataolursa="HATA_OLURSA_IPTAL_ET",

ozelkodlar="AKTARMA",

yetkikodlari="AKTARMA",

benzerlikkontrolu="BENZERLIK_KONTROLU_YAPILSIN",

eslenmeyenler="HATA_OLURSA_IPTAL_ET"

)

● XML formatında hazırlanmış irsaliye verilerinin Dia sistemine aktarılması amacıyla kullanılan

metottur.

● username:Dia kullanıcı ismi

● password:Dia kullanıcı şifresi

● xmlData:Aktarılacak kayıt bilgisini içeren XML verisi. İstenirse GZIP yöntemi ile sıkıştırılıp

daha  sonra  Base64  kodlamasından  geçirilmiş  veri  de  gönderilebilir.  Sistem  gönderilen

verinin formatını otomatik olarak algılayacak ve gerekli açma işlemini yapacaktır.

● subeKodu: Kayıtların aktarılacağı şubenin kodu.

● depoKodu: Kayıtların aktarılacağı deponun kodu.

● otomatikfisno: Kayıtların fiş no bilgilerinin nasıl oluşturulacağını belirtir.

● otomatikirsaliyeno: Kayıtların numara bilgilerinin nasıl oluşturulacağını belirtir.

● carikartkontrolu: İrsaliye bilgileri eşlenirken cari kart bilgisinin kontrol şekli.

● hataolursa: Hata durumunda davranış biçimi.

○ Dia sisteminde tanımlı bir şube kodu.

○ Öntanımlı değer:

■ "000001"

○ Dia  sisteminde  tanımlı  bir  depo  kodu  ya  da  XML  verisi  içerisinde  yer  alan  depo

kodunun kullanılması için özel değer "DEPOYU_KAYITTAN_AL"

○ Öntanımlı değer:

■ "DEPOYU_KAYITTAN_AL"

○ Alabileceği değerler:

■ "FISNO_KAYITTAN_ALINSIN"

■ "FISNO_OTOMATIK_VERILSIN"

○ Öntanımlı değer:

■ "FISNO_KAYITTAN_ALINSIN"

○ Alabileceği değerler:

■ "FISNO_KAYITTAN_ALINSIN"

■ "FISNO_OTOMATIK_VERILSIN"

○ Öntanımlı değer:

■ "FISNO_KAYITTAN_ALINSIN"

○ Alabileceği değerler:

■ "CARI_KONTROLU_VAR"

■ "CARI_KONTROLU_YOK"

○ Öntanımlı değer:

■ "CARI_KONTROLU_VAR"

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

● ozelkodlar: Kayıt özel kodları aktarım davranışı.

● yetkikodlari: Kayıt yetki kodları aktarım davranışı.

○ Öntanımlı değer:

■ "HATA_OLURSA_IPTAL_ET"

○ Alabileceği değerler:

■ "AKTARMA"

■ "AKTAR_YOKSA_OLUSTUR"

■ "SADECE_TANIMLI_AKTAR"

○ Öntanımlı değer:

■ "AKTARMA"

○ Alabileceği değerler:

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

○ Öntanımlı değer:

■ "AKTARMA"

● benzerlikkontrolu:Kayıt  numarası  daha  önce  girilmiş  kayıtlarla  aynı  olan  veriler  için

davranış biçimi.

● eslenmeyenler: Kayıt bilgileri eşlenirken hata oluşursa davranış biçimi.

○ Alabileceğı değerler:

■ "BENZERLIK_KONTROLU_YAPILSIN"

■ "BENZERLIK_KONTROLU_YAPILMASIN"

■ "BENZER_OLANI_YOKSAY"

○ Öntanımlı değer:

■ "BENZERLIK_KONTROLU_YAPILSIN"

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer: "HATA_OLURSA_IPTAL_ET"



scf.xmlImportSiparis(username,

password,

xmlData,

subeKodu="SUBEYI_KAYDIN_DEPOSUNDAN_AL",

depoKodu="DEPOYU_KAYITTAN_AL",

otomatikfisno="FISNO_KAYITTAN_ALINSIN",

carikartkontrolu="CARI_KONTROLU_VAR",

hataolursa="HATA_OLURSA_IPTAL_ET",

ozelkodlar="AKTARMA",

yetkikodlari="AKTARMA",

benzerlikkontrolu="BENZERLIK_KONTROLU_YAPILSIN",

eslenmeyenler="HATA_OLURSA_IPTAL_ET"

)

● XML formatında hazırlanmış sipariş verilerinin Dia sistemine aktarılması amacıyla kullanılan

metottur.

● username:Dia kullanıcı ismi

● password:Dia kullanıcı şifresi

● xmlData:Aktarılacak kayıt bilgisini içeren XML verisi. İstenirse GZIP yöntemi ile sıkıştırılıp

daha  sonra  Base64  kodlamasından  geçirilmiş  veri  de  gönderilebilir.  Sistem  gönderilen

verinin formatını otomatik olarak algılayacak ve gerekli açma işlemini yapacaktır.

● subeKodu: Kayıtların aktarılacağı şubenin kodu.

● depoKodu: Kayıtların aktarılacağı deponun kodu.

● otomatikfisno: Kayıtların fiş no bilgilerinin nasıl oluşturulacağını belirtir.

● otomatiksiparisno: Kayıtların numara bilgilerinin nasıl oluşturulacağını belirtir.

● carikartkontrolu: Kayıt bilgileri eşlenirken cari kart bilgisinin kontrol şekli.

● hataolursa: Hata durumunda davranış biçimi.

○ Dia  sisteminde  tanımlı  bir  şube  kodu  ya  da  XML  verisi  içerisinde  yer  alan  şube

kodunun kullanılması için özel değer “SUBEYI_KAYDIN_DEPOSUNDAN_AL”. ○ Öntanımlı değer:

■ "SUBEYI_KAYDIN_DEPOSUNDAN_AL"

○ Dia  sisteminde  tanımlı  bir  depo  kodu  ya  da  XML  verisi  içerisinde  yer  alan  depo

kodunun kullanılması için özel değer "DEPOYU_KAYITTAN_AL"

○ Öntanımlı değer:

■ "DEPOYU_KAYITTAN_AL"

○ Alabileceği değerler:

■ "FISNO_KAYITTAN_ALINSIN"

■ "FISNO_OTOMATIK_VERILSIN"

○ Öntanımlı değer:

■ "FISNO_KAYITTAN_ALINSIN"

○ Alabileceği değerler:

■ "FISNO_KAYITTAN_ALINSIN"

■ "FISNO_OTOMATIK_VERILSIN"

○ Öntanımlı değer:

■ "FISNO_KAYITTAN_ALINSIN"

○ Alabileceği değerler:

■ "CARI_KONTROLU_VAR"

■ "CARI_KONTROLU_YOK"

○ Öntanımlı değer:

■ "CARI_KONTROLU_VAR"

○ Alabileceği değerler:

● ozelkodlar: Kayıt özel kodları aktarım davranışı.

● yetkikodlari: Kayıt yetki kodları aktarım davranışı.

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer:

■ "HATA_OLURSA_IPTAL_ET"

○ Alabileceği değerler:

■ "AKTARMA"

■ "AKTAR_YOKSA_OLUSTUR"

■ "SADECE_TANIMLI_AKTAR"

○ Öntanımlı değer:

■ "AKTARMA"

○ Alabileceği değerler:

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

○ Öntanımlı değer:

■ "AKTARMA"

● benzerlikkontrolu:Kayıt  numarası  daha  önce  girilmiş  kayıtlarla  aynı  olan  veriler  için

davranış biçimi.

● eslenmeyenler: Kayıt bilgileri eşlenirken hata oluşursa davranış biçimi.

○ Alabileceğı değerler:

■ "BENZERLIK_KONTROLU_YAPILSIN"

■ "BENZERLIK_KONTROLU_YAPILMASIN"

■ "BENZER_OLANI_YOKSAY"

○ Öntanımlı değer:

■ "BENZERLIK_KONTROLU_YAPILSIN"

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer: "HATA_OLURSA_IPTAL_ET"



scf.xmlImportCariHesapFisi(username,

password,

xmlData,

subeKodu="000001",

hataolursa="HATA_OLURSA_IPTAL_ET",

ozelkodlar="AKTARMA",

yetkikodlari="AKTARMA",

benzerlikkontrolu="BENZERLIK_KONTROLU_YAPILSIN",

eslenmeyenler="HATA_OLURSA_IPTAL_ET"

)

● XML formatında hazırlanmış Cari Hesap Fişi verilerinin Dia sistemine aktarılması amacıyla

kullanılan metottur.

● username:Dia kullanıcı ismi

● password:Dia kullanıcı şifresi

● xmlData:Aktarılacak fatura bilgisini içeren XML verisi. İstenirse GZIP yöntemi ile sıkıştırılıp

daha  sonra  Base64  kodlamasından  geçirilmiş  veri  de  gönderilebilir.  Sistem  gönderilen

verinin formatını otomatik olarak algılayacak ve gerekli açma işlemini yapacaktır.

● subeKodu: Cari hesap fişlerinin aktarılacağı şubenin kodu.

● hataolursa: Hata durumunda davranış biçimi.

● ozelkodlar: Fatura özel kodları aktarım davranışı.

● yetkikodlari: Fatura yetki kodları aktarım davranışı.

○ Dia sisteminde tanımlı bir şube kodu.

○ Öntanımlı değer:

■ "000001"

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer:

■ "HATA_OLURSA_IPTAL_ET"

○ Alabileceği değerler:

■ "AKTARMA"

■ "AKTAR_YOKSA_OLUSTUR"

■ "SADECE_TANIMLI_AKTAR"

○ Öntanımlı değer:

■ "AKTARMA"

○ Alabileceği değerler:

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

○ Öntanımlı değer:

■ "AKTARMA"

● benzerlikkontrolu:Fatura numarası daha önce girilmiş kayıtlarla aynı olan faturalar için

davranış biçimi.

● eslenmeyenler: Fatura bilgileri eşlenirken hata oluşursa davranış biçimi.

○ Alabileceğı değerler:

■ "BENZERLIK_KONTROLU_YAPILSIN"

■ "BENZERLIK_KONTROLU_YAPILMASIN"

■ "BENZER_OLANI_YOKSAY"

○ Öntanımlı değer:

■ "BENZERLIK_KONTROLU_YAPILSIN"

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

○ Öntanımlı değer:

● otomatikfisno: Kayıtların fiş no bilgilerinin nasıl oluşturulacağını belirtir.

○ Alabileceği değerler:

■ "HATAYI_GOSTER_DEVAM_ET"

■ "HATA_OLURSA_IPTAL_ET"

○ Öntanımlı değer:

● otomatikbelgeno: Kayıtların numara bilgilerinin nasıl oluşturulacağını belirtir.

○ Alabileceği değerler:

■ "FISNO_KAYITTAN_ALINSIN"

■ "FISNO_OTOMATIK_VERILSIN"

■ "FISNO_KAYITTAN_ALINSIN"

○ Öntanımlı değer:

■ "FISNO_KAYITTAN_ALINSIN"

■ "FISNO_OTOMATIK_VERILSIN"

■ "FISNO_KAYITTAN_ALINSIN"

scf.xmlImportMalzemeFisi(username,

password,

xmlData,

subeKodu="000001",

depoKodu="DEPOYU_KAYITTAN_AL",

karsiSubeKodu="000001",

karsiDepoKodu="DEPOYU_KAYITTAN_AL",

hataolursa="HATA_OLURSA_IPTAL_ET",

ozelkodlar="AKTARMA",

yetkikodlari="AKTARMA",

benzerlikkontrolu="BENZERLIK_KONTROLU_YAPILSIN"

)

● XML  formatında  hazırlanmış  malzeme  fişi  verilerinin  Dia  sistemine  aktarılması  amacıyla

kullanılan metottur.

● username:Dia kullanıcı ismi

● password:Dia kullanıcı şifresi

● xmlData:Aktarılacak  malzeme  fişi  bilgisini  içeren  XML  verisi.  İstenirse  GZIP  yöntemi  ile

sıkıştırılıp  daha  sonra  Base64  kodlamasından  geçirilmiş  veri  de  gönderilebilir.  Sistem

gönderilen verinin formatını otomatik olarak algılayacak ve gerekli açma işlemini yapacaktır.

● subeKodu: Malzeme fişlerinin aktarılacağı kaynak şubenin kodu.

● depoKodu: Malzeme fişlerinin aktarılacağı kaynak deponun kodu.

○ Dia sisteminde tanımlı bir şube kodu.

○ Öntanımlı değer:

■ "000001"

○ Dia  sisteminde  tanımlı  bir  depo  kodu  ya  da  XML  verisi  içerisinde  yer  alan  depo

kodunun kullanılması için özel değer "DEPOYU_KAYITTAN_AL"

○ Öntanımlı değer:

■ "DEPOYU_KAYITTAN_AL"

● karsiSubeKodu:Malzeme fişlerinin aktarılacağı hedef şubenin kodu. Depo transfer fişlerinin

aktarımında geçerlidir.

○ Dia sisteminde tanımlı bir şube kodu.

○ Öntanımlı değer:

■ "000001"

● karsiDepoKodu: Malzeme  fişlerinin  aktarılacağı  hedef  deponun  kodu.  Depo  transfer

fişlerinin aktarımında geçerlidir.

● hataolursa: Hata durumunda davranış biçimi.

● ozelkodlar: Malzeme fişi özel kodları aktarım davranışı.

○ Dia  sisteminde  tanımlı  bir  depo  kodu  ya  da  XML  verisi  içerisinde  yer  alan  depo

kodunun kullanılması için özel değer "DEPOYU_KAYITTAN_AL"

○ Öntanımlı değer:

■ "DEPOYU_KAYITTAN_AL"

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer:

■ "HATA_OLURSA_IPTAL_ET"

○ Alabileceği değerler:

■ "AKTARMA"

■ "AKTAR_YOKSA_OLUSTUR"

■ "SADECE_TANIMLI_AKTAR"

○ Öntanımlı değer:

■ "AKTARMA"

● yetkikodlari: Malzeme fişi yetki kodları aktarım davranışı.

○ Alabileceği değerler:

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

■ "AKTARMA"

○ Öntanımlı değer:

● benzerlikkontrolu:Malzeme  fişi  numarası  daha  önce  girilmiş  kayıtlarla  aynı  olan  fişler

için davranış biçimi.

○ Alabileceğı değerler:

○ Öntanımlı değer:

■ "BENZERLIK_KONTROLU_YAPILSIN"

■ "BENZERLIK_KONTROLU_YAPILMASIN"

■ "BENZER_OLANI_YOKSAY"

■ "BENZERLIK_KONTROLU_YAPILSIN"

scf.xmlImportKasaFisi(username,

password,

xmlData,

subeKodu="000001",

otomatikfisno="FISNO_KAYITTAN_ALINSIN",

hataolursa="HATA_OLURSA_IPTAL_ET",

ozelkodlar="AKTARMA",

yetkikodlari="AKTARMA",

benzerlikkontrolu="BENZERLIK_KONTROLU_YAPILSIN",

)

● XML  formatında  hazırlanmış  kasa  fişi  verilerinin  Dia  sistemine  aktarılması  amacıyla

kullanılan metottur.

● username:Dia kullanıcı ismi

● password:Dia kullanıcı şifresi

● xmlData: Aktarılacak  kasa  fişi  bilgisini  içeren  XML  verisi.  İstenirse  GZIP  yöntemi  ile

sıkıştırılıp  daha  sonra  Base64  kodlamasından  geçirilmiş  veri  de  gönderilebilir.  Sistem

gönderilen verinin formatını otomatik olarak algılayacak ve gerekli açma işlemini yapacaktır.

● subeKodu: Kasa fişlerinin aktarılacağı şubenin kodu.

● otomatikfisno: Kasa fiş no bilgilerinin nasıl oluşturulacağını belirtir.

● hataolursa: Hata durumunda davranış biçimi.

● ozelkodlar: Kasa fişleri özel kodları aktarım davranışı.

● yetkikodlari: Kasa fişleri yetki kodları aktarım davranışı.

○ Dia sisteminde tanımlı bir şube kodu.

○ Öntanımlı değer:

■ "000001"

○ Alabileceği değerler:

■ "FISNO_KAYITTAN_ALINSIN"

■ "FISNO_OTOMATIK_VERILSIN"

○ Öntanımlı değer:

■ "FISNO_KAYITTAN_ALINSIN"

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer:

■ "HATA_OLURSA_IPTAL_ET"

○ Alabileceği değerler:

■ "AKTARMA"

■ "AKTAR_YOKSA_OLUSTUR"

■ "SADECE_TANIMLI_AKTAR"

○ Öntanımlı değer:

■ "AKTARMA"

○ Alabileceği değerler:

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

○ Öntanımlı değer:

■ "AKTARMA"

● benzerlikkontrolu:Kasa  fiş  numarası  daha  önce  girilmiş  kayıtlarla  aynı  olan  fişler  için

davranış biçimi.

○ Alabileceğı değerler:

■ "BENZERLIK_KONTROLU_YAPILSIN"

■ "BENZERLIK_KONTROLU_YAPILMASIN"

● eslenmeyenler: Kayıt bilgileri eşlenirken hata oluşursa davranış biçimi.

■ "BENZER_OLANI_YOKSAY"

○ Öntanımlı değer:

■ "BENZERLIK_KONTROLU_YAPILSIN"

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer: "HATA_OLURSA_IPTAL_ET"



bcs.xmlImportBankaFisi(username,

password,

xmlData,

subeKodu="000001",

hataolursa="HATA_OLURSA_IPTAL_ET",

ozelkodlar="AKTARMA",

yetkikodlari="AKTARMA",

benzerlikkontrolu="BENZERLIK_KONTROLU_YAPILSIN",

)

● XML  formatında  hazırlanmış  banka  fişi  verilerinin  Dia  sistemine  aktarılması  amacıyla

kullanılan metottur.

● username:Dia kullanıcı ismi

● password:Dia kullanıcı şifresi

● xmlData: Aktarılacak  kasa  fişi  bilgisini  içeren  XML  verisi.  İstenirse  GZIP  yöntemi  ile

sıkıştırılıp  daha  sonra  Base64  kodlamasından  geçirilmiş  veri  de  gönderilebilir.  Sistem

gönderilen verinin formatını otomatik olarak algılayacak ve gerekli açma işlemini yapacaktır.

● subeKodu: Kasa fişlerinin aktarılacağı şubenin kodu.

● hataolursa: Hata durumunda davranış biçimi.

● ozelkodlar: Kasa fişleri özel kodları aktarım davranışı.

● yetkikodlari: Kasa fişleri yetki kodları aktarım davranışı.

○ Dia sisteminde tanımlı bir şube kodu.

○ Öntanımlı değer:

■ "000001"

○ Alabileceği değerler:

■ "HATA_OLURSA_IPTAL_ET"

■ "HATAYI_GOSTER_DEVAM_ET"

○ Öntanımlı değer:

■ "HATA_OLURSA_IPTAL_ET"

○ Alabileceği değerler:

■ "AKTARMA"

■ "AKTAR_YOKSA_OLUSTUR"

■ "SADECE_TANIMLI_AKTAR"

○ Öntanımlı değer:

■ "AKTARMA"

○ Alabileceği değerler:

■ "AKTARMA"

■ "SADECE_TANIMLI_AKTAR"

■ "AKTAR_YOKSA_OLUSTUR"

○ Öntanımlı değer:

■ "AKTARMA"

● benzerlikkontrolu:Kasa  fiş  numarası  daha  önce  girilmiş  kayıtlarla  aynı  olan  fişler  için

davranış biçimi.

○ Alabileceğı değerler:

■ "BENZERLIK_KONTROLU_YAPILSIN"

■ "BENZERLIK_KONTROLU_YAPILMASIN"

■ "BENZER_OLANI_YOKSAY"

○ Öntanımlı değer:

■ "BENZERLIK_KONTROLU_YAPILSIN"

Dışa Aktarım Metotları (Dia’dan)

scf.xmlExportStok(username,

password,

lastModifiedStart=Null,

lastModifiedEnd=Null,

stokkartkodu=Null,

)

● Dia’da  tanımlı  stok  kartlarının  dışarıya  XML  formatında  aktarılması  amacıyla  kullanılır.

Sadece aktif durumdaki stok kartları aktarılır.

● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● lastModifiedStart:Opsiyonel olarak gönderilebilecek kayıt başlangıç modifikasyon tarihi.

ISO  formatında  string  olarak  gönderilmelidir,  örneğin  "2010‐02‐24" gibi.  Gönderilirse

sadece gönderilen tarih  ve  sonrasında güncellenmiş  ve/veya eklenmiş  kayıtlar döndürülür.

Verilen parametre tarih aralığına dahildir.

● lastModifiedEnd:Opsiyonel  olarak  gönderilebilecek  kayıt  bitiş  modifikasyon  tarihi.  ISO

formatında  string  olarak  gönderilmelidir,  örneğin  "2010‐02‐25"gibi.  Gönderilirse  sadece

gönderilen  tarih  öncesinde  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür.  Verilen

parametre  tarih  aralığına  dahil  edilmez.  Bu  parametrenin  gönderilebilmesi  için  mutlaka

lastModifiedStart parametresinin de gönderilmesi gerekir.

● stokkartkodu:Gönderilirse  lastModifiedStart  ve  lastModifiedEnd  parametrelerini  dikkate

almadan sadece stokkartkoduna göre filtreleme yapar

● Dönen değer (hata olmadığı durumda):

{"durum":"200","xmldata":"disari_aktarilan_xml_verisi"}

scf.xmlExportCari(username,

password,

lastModifiedStart=Null,

lastModifiedEnd=Null,

carikartkodu=Null,

)

● Dia’da tanımlı cari kartların dışarıya XML formatında aktarılması amacıyla kullanılır. Sadece

aktif durumdaki cari kartlar aktarılır.

● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● lastModifiedStart:Opsiyonel olarak gönderilebilecek kayıt başlangıç modifikasyon tarihi.

ISO formatında string olarak gönderilmelidir, örneğin “2010­02­24” gibi. Gönderilirse sadece

gönderilen  tarih  ve  sonrasında  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür. Verilen

parametre tarih aralığına dahildir.

● lastModifiedEnd:Opsiyonel  olarak  gönderilebilecek  kayıt  bitiş  modifikasyon  tarihi.  ISO

formatında  string  olarak  gönderilmelidir,  örneğin  “2010­02­25”  gibi.  Gönderilirse  sadece

gönderilen  tarih  öncesinde  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür.  Verilen

parametre  tarih  aralığına  dahil  edilmez.  Bu  parametrenin  gönderilebilmesi  için  mutlaka

lastModifiedStart parametresinin de gönderilmesi gerekir.

● carikartkodu:Gönderilirse  lastModifiedStart  ve  lastModifiedEnd  parametrelerini  dikkate

almadan sadece carikartkoduna göre filtreleme yapar

● Dönen değer (hata olmadığı durumda):

{"durum":"200","xmldata":"disari_aktarilan_xml_verisi"}

scf.xmlExportFatura(username,

password,

lastModifiedStart=Null,

lastModifiedEnd=Null,

fisno=Null,

)

● Dia’da  tanımlı  faturaların  dışarıya  XML  formatında  aktarılması  amacıyla  kullanılır.  İptal

edilmiş durumda olan faturalar da aktarılır. ● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● lastModifiedStart:Opsiyonel olarak gönderilebilecek kayıt başlangıç modifikasyon tarihi.

ISO formatında string olarak gönderilmelidir, örneğin “2010­02­24” gibi. Gönderilirse sadece

gönderilen  tarih  ve  sonrasında  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür. Verilen

parametre tarih aralığına dahildir.

● lastModifiedEnd:Opsiyonel  olarak  gönderilebilecek  kayıt  bitiş  modifikasyon  tarihi.  ISO

formatında  string  olarak  gönderilmelidir,  örneğin  “2010­02­25”  gibi.  Gönderilirse  sadece

gönderilen  tarih  öncesinde  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür.  Verilen

parametre  tarih  aralığına  dahil  edilmez.  Bu  parametrenin  gönderilebilmesi  için  mutlaka

lastModifiedStart parametresinin de gönderilmesi gerekir.

● fisno:Gönderilirse  lastModifiedStart  ve  lastModifiedEnd  parametrelerini  dikkate  almadan

sadece fisno ya göre filtreleme yapar

● Dönen değer (hata olmadığı durumda):

{"durum":"200","xmldata":"disari_aktarilan_xml_verisi"}

scf.xmlExportIrsaliye(username,

password,

lastModifiedStart=Null,

lastModifiedEnd=Null,

fisno=Null,

)

● Dia’da  tanımlı  irsaliyelerin  dışarıya  XML  formatında  aktarılması  amacıyla  kullanılır.  İptal

edilmiş durumda olan irsaliyeler de aktarılır. ● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● lastModifiedStart:Opsiyonel olarak gönderilebilecek kayıt başlangıç modifikasyon tarihi.

ISO formatında string olarak gönderilmelidir, örneğin “2010­02­24” gibi. Gönderilirse sadece

gönderilen  tarih  ve  sonrasında  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür. Verilen

parametre tarih aralığına dahildir.

● lastModifiedEnd:Opsiyonel  olarak  gönderilebilecek  kayıt  bitiş  modifikasyon  tarihi.  ISO

formatında  string  olarak  gönderilmelidir,  örneğin  “2010­02­25”  gibi.  Gönderilirse  sadece

gönderilen  tarih  öncesinde  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür.  Verilen

parametre  tarih  aralığına  dahil  edilmez.  Bu  parametrenin  gönderilebilmesi  için  mutlaka

lastModifiedStart parametresinin de gönderilmesi gerekir.

● fisno:Gönderilirse  lastModifiedStart  ve  lastModifiedEnd  parametrelerini  dikkate  almadan

sadece fisno ya göre filtreleme yapar

● Dönen değer (hata olmadığı durumda):

{"durum":"200","xmldata":"disari_aktarilan_xml_verisi"}

scf.xmlExportSiparis(username,

password,

lastModifiedStart=Null,

lastModifiedEnd=Null,

fisno=Null,

)

● Dia’da  tanımlı  siparişlerin  dışarıya  XML  formatında  aktarılması  amacıyla  kullanılır.  İptal

edilmiş durumda olan irsaliyeler de aktarılır. ● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● lastModifiedStart:Opsiyonel olarak gönderilebilecek kayıt başlangıç modifikasyon tarihi.

ISO formatında string olarak gönderilmelidir, örneğin “2010­02­24” gibi. Gönderilirse sadece

gönderilen  tarih  ve  sonrasında  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür. Verilen

parametre tarih aralığına dahildir.

● lastModifiedEnd:Opsiyonel  olarak  gönderilebilecek  kayıt  bitiş  modifikasyon  tarihi.  ISO

formatında  string  olarak  gönderilmelidir,  örneğin  “2010­02­25”  gibi.  Gönderilirse  sadece

gönderilen  tarih  öncesinde  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür.  Verilen

parametre  tarih  aralığına  dahil  edilmez.  Bu  parametrenin  gönderilebilmesi  için  mutlaka

lastModifiedStart parametresinin de gönderilmesi gerekir.

● fisno:Gönderilirse  lastModifiedStart  ve  lastModifiedEnd  parametrelerini  dikkate  almadan

sadece fisno ya göre filtreleme yapar

Dönen değer (hata olmadığı durumda):

{"durum":"200","xmldata":"disari_aktarilan_xml_verisi"}



scf.xmlExportCariHesapFisi(username,

password,

lastModifiedStart=Null,

lastModifiedEnd=Null,

)

● Dia’da tanımlı Cari Hesap Fişlerinin dışarıya XML formatında aktarılması amacıyla kullanılır.

● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● lastModifiedStart:Opsiyonel olarak gönderilebilecek kayıt başlangıç modifikasyon tarihi.

ISO formatında string olarak gönderilmelidir, örneğin “2010­02­24” gibi. Gönderilirse sadece

gönderilen  tarih  ve  sonrasında  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür. Verilen

parametre tarih aralığına dahildir.

● lastModifiedEnd:Opsiyonel  olarak  gönderilebilecek  kayıt  bitiş  modifikasyon  tarihi.  ISO

formatında  string  olarak  gönderilmelidir,  örneğin  “2010­02­25”  gibi.  Gönderilirse  sadece

gönderilen  tarih  öncesinde  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür.  Verilen

parametre  tarih  aralığına  dahil  edilmez.  Bu  parametrenin  gönderilebilmesi  için  mutlaka

lastModifiedStart parametresinin de gönderilmesi gerekir.

● Dönen değer (hata olmadığı durumda):

{"durum":"200","xmldata":"disari_aktarilan_xml_verisi"}

scf.xmlExportMalzemeFisi(username,

password,

lastModifiedStart=Null,

lastModifiedEnd=Null,

)

● Dia’da tanımlı Malzeme Fişlerinin dışarıya XML formatında aktarılması amacıyla kullanılır.

● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● lastModifiedStart:Opsiyonel olarak gönderilebilecek kayıt başlangıç modifikasyon tarihi.

ISO formatında string olarak gönderilmelidir, örneğin “2010­02­24” gibi. Gönderilirse sadece

gönderilen  tarih  ve  sonrasında  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür. Verilen

parametre tarih aralığına dahildir.

● lastModifiedEnd:Opsiyonel  olarak  gönderilebilecek  kayıt  bitiş  modifikasyon  tarihi.  ISO

formatında  string  olarak  gönderilmelidir,  örneğin  “2010­02­25”  gibi.  Gönderilirse  sadece

gönderilen  tarih  öncesinde  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür.  Verilen

parametre  tarih  aralığına  dahil  edilmez.  Bu  parametrenin  gönderilebilmesi  için  mutlaka

lastModifiedStart parametresinin de gönderilmesi gerekir.

● Dönen değer (hata olmadığı durumda):

{"durum":"200","xmldata":"disari_aktarilan_xml_verisi"}

scf.xmlExportKasaFisi(username,

password,

lastModifiedStart=Null,

lastModifiedEnd=Null,

)

● Dia’da tanımlı kasa fişlerinin dışarıya XML formatında aktarılması amacıyla kullanılır.

● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● lastModifiedStart:Opsiyonel olarak gönderilebilecek kayıt başlangıç modifikasyon tarihi.

ISO formatında string olarak gönderilmelidir, örneğin “2010­02­24” gibi. Gönderilirse sadece

gönderilen  tarih  ve  sonrasında  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür. Verilen

parametre tarih aralığına dahildir.

● lastModifiedEnd:Opsiyonel  olarak  gönderilebilecek  kayıt  bitiş  modifikasyon  tarihi.  ISO

formatında  string  olarak  gönderilmelidir,  örneğin  “2010­02­25”  gibi.  Gönderilirse  sadece

gönderilen  tarih  öncesinde  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür.  Verilen

parametre  tarih  aralığına  dahil  edilmez.  Bu  parametrenin  gönderilebilmesi  için  mutlaka

lastModifiedStart parametresinin de gönderilmesi gerekir.

● Dönen değer (hata olmadığı durumda):

{"durum":"200","xmldata":"disari_aktarilan_xml_verisi"}

bcs.xmlExportBankaFisi(username,

password,

lastModifiedStart=Null,

lastModifiedEnd=Null,

)

● Dia’da tanımlı banka fişlerinin dışarıya XML formatında aktarılması amacıyla kullanılır.

● username:Dia kullanıcı ismi.

● password:Dia kullanıcı şifresi.

● lastModifiedStart:Opsiyonel olarak gönderilebilecek kayıt başlangıç modifikasyon tarihi.

ISO formatında string olarak gönderilmelidir, örneğin “2010­02­24” gibi. Gönderilirse sadece

gönderilen  tarih  ve  sonrasında  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür. Verilen

parametre tarih aralığına dahildir.

● lastModifiedEnd:Opsiyonel  olarak  gönderilebilecek  kayıt  bitiş  modifikasyon  tarihi.  ISO

formatında  string  olarak  gönderilmelidir,  örneğin  “2010­02­25”  gibi.  Gönderilirse  sadece

gönderilen  tarih  öncesinde  güncellenmiş  ve/veya  eklenmiş  kayıtlar  döndürülür.  Verilen

parametre  tarih  aralığına  dahil  edilmez.  Bu  parametrenin  gönderilebilmesi  için  mutlaka

lastModifiedStart parametresinin de gönderilmesi gerekir.

● Dönen değer (hata olmadığı durumda):

{"durum":"200","xmldata":"disari_aktarilan_xml_verisi"}

Web Servis Çağırma Örnekleri

Java ­ XML

(Örnek Java kodu ve ilgili JSONRPC kütüphanesi http://dl.dia.gen.tr/api/DiaWS­JavaClient.zip

adresinden indirilebilir)

//‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐

//DiaJSON‐RPCwebservisiJavaornegi

//‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐

//TheClientsessionspackage

importcom.thetransactioncompany.jsonrpc2.client.*;

//TheBasepackageforrepresentingJSON‐RPC2.0messages

importcom.thetransactioncompany.jsonrpc2.*;

//TheJSONSmartpackageforJSONencoding/decoding(optional)

importnet.minidev.json.*;

//ForcreatingURLs

importjava.net.*;

importjava.util.List;

importjava.util.ArrayList;

publicclassExample{

publicstaticvoidmain(String[]args){

//CreatinganewsessiontoaJSON‐RPC2.0webserviceataspecifiedURL

//TheJSON‐RPC2.0serverURL

URLserverURL=null;

try{

serverURL=newURL("http://sunucukodu.json.dia.gen.tr/");

}catch(MalformedURLExceptione){

}

//CreatenewJSON‐RPC2.0clientsession

JSONRPC2SessionmySession=newJSONRPC2Session(serverURL);

mySession.getOptions().setAllowedResponseContentTypes(newString[]{"text/html",

"text/json"});

mySession.getOptions().ignoreVersion(true);

mySession.getOptions().parseNonStdAttributes(true);

//‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐

//BirinciOrnek,Dia'datanimlistokkartlarininalinmasi

//‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐

Stringmethod="scf.xmlExportStok";

List<String>params=newArrayList<String>();

intrequestID=0;

params.add("kullanici");//Kullaniciadi

params.add("sifre");//Sifre

//handleexception...

//‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐

//IkinciOrnek,Dia'yaFaturaaktarimi

//‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐

//Stringmethod="scf.xmlImportFatura";

//List<String>params=newArrayList<String>();

//intrequestID=1;

//Stringxml="<xml>UyumluXMLVerisiBuStringIcerisindeYerAlmali</xml>";

//params.add("kullanici");//Kullaniciadi

//params.add("sifre");//Sifre

//params.add(xml);

//params.add("001");//Subekodu

//params.add("DEPOYU_KAYITTAN_AL");

//params.add("FISNO_KAYITTAN_ALINSIN");

//params.add("FISNO_KAYITTAN_ALINSIN");

//params.add("HATA_OLURSA_IPTAL_ET");

//params.add("AKTARMA");

//params.add("AKTARMA");

//params.add("BENZERLIK_KONTROLU_YAPILMASIN");

//params.add("HATA_OLURSA_IPTAL_ET");

JSONRPC2Requestrequest=newJSONRPC2Request(method,params,requestID);

//Sendrequest

JSONRPC2Responseresponse=null;

try{

response=mySession.send(request);

}catch(JSONRPC2SessionExceptione){

System.err.println(e.getMessage());

//handleexception...

}

//Printresponseresult/error

if(response.indicatesSuccess())

//Sonucburadaaliniyor...

System.out.println(response.getResult());

System.out.println(response.getError().getMessage());

else

}

}

C# XML

(JayRock Kütüphanesi Kullanarak http://code.google.com/p/jayrock/downloads/list, reference Jayrock.dll,

Jayrock.Json.dll, Jayrock.Sandbox.dll)

usingSystem;

usingSystem.Collections;

usingSystem.Net;

usingJayrock.Json;

usingJayrock.JsonRpc;

namespaceDiaWS

{

classMainClass

{

publicstaticvoidMain(string[]args)

{

varclient=newJsonRpcClient{

Url="http://sunucukodu.json.dia.gen.tr/"

};

varjsonObj=client.InvokeVargs("scf.xmlExportStok","kullanici","sifre");

Console.WriteLine(jsonObj);

}

}

}

C# JSON

usingSystem;

usingSystem.Collections.Generic;

usingSystem.Linq;

usingSystem.Text;

usingJayrock.Json;

usingJayrock.JsonRpc;

usingSystem.Web;

namespaceJSON

{

classMainClass

{

publicstaticvoidMain(string[]args)

{

intoffset=0,limit=5;

stringdictFormat="True",disconnectSameUser="True";

JsonRpcClientclient=newJsonRpcClient();

//JsonRpcbağlantısısağlayacakistemcioluşturuluyor.

client.Url="http://sunucukodu.json.dia.gen.tr/";

//Sunucuyabağlanıyoruz.

varsessionID=client.InvokeVargs("login","kullaniciadi","sifre",

"127.0.0.1",disconnectSameUser);

sessionID,offset,limit,filters,dictFormat);

try

{

//Filtrelerioluşturuyoruz.

JsonArrayfilters=newJsonArray();

filters.Add(newJsonArray(newstring[]{"sehir","=","ANKARA"}));

//Cağrıyapıyoruz.

objectcariKartListesi=client.InvokeVargs("scf.cariKartListesi",

Console.WriteLine(cariKartListesi);

}

catch(Exceptione)

{

Console.WriteLine(e);

}

//Sunucuylabağlantıyıkesiyoruz.

client.InvokeVargs("logout",sessionID);

}

}

}
Proje Grup

Kavaklıdere Cd. No: 8/4
Ümraniye / İstanbul
info@jestbilgisayar.com
+90 216 412 00 00
Copyright © 2013 Proje Group